home *** CD-ROM | disk | FTP | other *** search
/ The Programmer Disk / The Programmer Disk (Microforum).iso / xpro / basic1 / pro24 / basexec.doc next >
Text File  |  1987-11-12  |  4KB  |  98 lines
  1.  
  2.  
  3.  
  4.                              BASEXEC DOCUMENTATION
  5.  
  6.     MOVBASV3 is a superb way to run BASICA on your clone and be true to the
  7. original BASIC.  But I've found that it causes major problems on exit with some
  8. clones.  Because SBASICA.COM replaces the BASICA interrupt vector (at
  9. 0000:0060) in the base page, some compiled BASIC programs lock up the machine
  10. BIG TIME after you run SBASICA.  To get around this problem, try the included
  11. BASICA.EXE loader which 1) saves the BASICA interrupt vector, and 2) EXEC's
  12. SBASICA.COM (or SBASIC.COM).  When you exit SBASICA, this loader then restores
  13. the BASIC interrupt vector.  BASICA.EXE even passes along any arguments you
  14. pass to BASICA (such as a filename or options like BASICA MENU /F:5).
  15.  
  16.     If you run SBASICA.COM and experience no problems, then don't bother with
  17. this process.  If, however, you have to run compiled BASICA applications after
  18. running SBASICA, and your machine DOES lock up, read on.
  19.  
  20. Running BASICA:  (NOTE:  Although you'll see BASICA and BASICA.COM, the same
  21. procedures are available for BASIC.  Just replace every occurrence of BASICA
  22. with BASIC to use Disk based BASIC.COM instead of Advanced BASICA.COM)
  23.  
  24.     QUICK START.  If you always run BASICA from the current directory, then
  25. extract BASICA.EXE and place it in the current directory, along with
  26. SBASICA.COM.  Now when you type BASICA, BASICA.EXE will run SBASICA.COM
  27. automatically for you.
  28.  
  29.     If you want BASIC available anywhere along your path, you have a bit more
  30. work to do.
  31.  
  32.     BASICA.EXE AVAILABLE ANYWHERE ON YOUR PATH.  For this procedure, you need
  33. to either patch the P-BASICA.EXE files provided or re-assemble BASICA.ASM.
  34. I'll first discuss how to modify the ASM file and then, armed with that
  35. understanding, I'll show you how to modify the EXE files.
  36.  
  37.     MODIFYING BASICA.ASM.  BASICA.EXE uses function call $4B to load and
  38. execute a program.  This is accomplished by calling COMMAND.COM to accomplish
  39. the task, passing SBASICA.COM as a parameter to COMMAND.COM.  The relevant
  40. code is listed below:
  41.  
  42.                 #    ___x:\path\filename___
  43.                 |   /                      \
  44.                 v  |                        |
  45. COMMAND db      25,'/C C:\GAMES\SBASICA.com '
  46. ComTail db      256 dup (0)                     ;Place for the command tail
  47.         db      13,0                            ;syntax
  48. PROGRAM db      'C:\COMMAND.COM',0              ;file to call
  49.  
  50.  
  51.  
  52.  
  53.     The currently installed path is C:\GAMES\SBASICA.COM.  If will have
  54. SBASICA in a subdirectory named GAMES, then just rename P-BASICA.EXE to
  55. BASICA.EXE and move to the GAMES subdirectory and you are ready to go.
  56.  
  57.     If you need to install another path, then
  58.         1.  Change the drive\path to your desired path.
  59.         2.  Change the # value to the length of the string between the quotes
  60. plus 1.  Be sure to include and count the space after COM.
  61.  
  62.     Now reassemble using IBM's or Microsoft's Macro Assembler by typing:
  63.  
  64.     MASM BASICA;
  65.     LINK BASICA;
  66.  
  67. Ignore the warning.
  68.  
  69. Now place this file, along with SBASICA.COM in the desired directory and
  70. ensure you have a path to this directory.  (Ensure that you do not have any
  71. other files named BASICA.EXE, BASICA.BAT, BASICA.COM, etc., on your path
  72. before the directory where you have loaded SBASICA.COM.)
  73.  
  74.     MODIFYING BASICA.EXE:  You can modify P-BASICA.EXE if you have a path that
  75. is the same length as C:\GAMES\.  To do so,
  76.  
  77.     1.  REName P-BASICA.EXE BASICA.XXX.
  78.     2.  Type:
  79.         DEBUG BASICA.XXX.
  80.     3.  Find the occurrence of C:\GAMES\SBASICA.COM (usually around
  81. xxxx:0310).  The xxxx value will vary from time to time.
  82.     4.  Use the [E]xamine command to change the path to your desired path.  If
  83. you have extra room left over, then fill the extra bytes with spaces.  For
  84. example, if your desired path is:
  85.  
  86.         C:\GA\SBASICA.COM then the completed patch will show the following
  87. before you save it:
  88.  
  89.     'C:\GA\SBASICA.COM    '
  90.                       ^^^  extra spaces
  91.  
  92.     5.  Now [W]rite it back to disk and [Q]uit DEBUG.
  93.     6.  REName BASICA.XXX BASICA.EXE and you are done.
  94.  
  95. If more extensive modifications are needed, then modify the ASM file and re-
  96. assemble it.
  97.  
  98.